home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 52 / Amiga Format AFCD52 (Issue 136, May 2000).iso / -serious- / workbench / clockcal / clockcal.readme < prev    next >
Text File  |  2000-02-28  |  8KB  |  201 lines
  1. Short:    WB Calender/World Clock with 4 clock faces
  2. Author:   mike@mikech.demon.co.uk
  3. Uploader: mike@mikech.demon.co.uk
  4. Type:     util/wb
  5. Replaces: util/wb/ClockCal.lha
  6.  
  7. Version 1.1 - Added automatic update of today indicator
  8.               in calendar at turn of midnight. 
  9.  
  10.  
  11. 1. INTRODUCTION
  12.  
  13. ClockCal opens a window on your WB containing up to  four
  14. analogue clock faces which can be configured to show  the
  15. current  time  in  different  world  locations,  with  or
  16. without  Daylight Saving Time in force, plus  a  calendar
  17. for  the  current (or any other) month. Gadgets exist  to
  18. toggle  the  display between just the  clocks,  just  the
  19. calendar  or  both.  Events may be noted  for  particular
  20. dates and those days will be highlighted in the calendar.
  21.  
  22. The  window sizing takes account of the title bar  height
  23. so should work irrespective of your system font, and safe
  24. guards  exist  to  prevent the  window  failing  to  open
  25. because  part of it is off screen etc. (since the  window
  26. changes size depending on how many clocks you have active
  27. and whether the calendar is on).
  28.  
  29. I  wrote  this  programme for  my  own  use  and  do  not
  30. anticipate  further development. It is Freeware.  If  you
  31. find it useful complements are always welcome!
  32.  
  33.  
  34. 2. INSTALLATION
  35.  
  36. None required. Copy the directory wherever you want it.
  37.  
  38.  
  39. 3. USAGE
  40.  
  41. Double  click the ClockCal icon. The window will open  in
  42. the  same  state as last time you closed it, in the  same
  43. position on the screen.
  44.  
  45. 3.1 CONFIGURING THE CLOCKS
  46.  
  47. The  Clocks.. gadget opens a new window containing a  set
  48. of  gadgets for each of the four possible clocks.  It  is
  49. essential that Clock 1 is set to show your local (system)
  50. time,  but with the correct time zone difference and  DST
  51. setting, as this clock is used to calculate GMT, which in
  52. turn  is used to calculate all the other clocks. Clock  1
  53. need  not be on, but it must be set right. Clocks with  a
  54. tick  in the ON checkbox will be displayed in the window.
  55. When  the DST checkbox is ticked the clock will have  the
  56. DST value (usually 1 hour) added to it. Note the timezone
  57. is set using a GMT +/- cycle gadget and a number of hours
  58. and  minutes  - do not put a sign in the time  difference
  59. box.
  60.  
  61. Close the window for the new settings to take effect.
  62.  
  63. 3.2 USING THE CALENDAR
  64.  
  65. The month displayed by the calendar always starts off  as
  66. the  current month. The cycle gadget enables you to  view
  67. different months (remember that the Shift key makes  this
  68. cycle  backwards!).  Going from December  to  January  or
  69. January  to December will also change the year,  but  any
  70. year  may be viewed by typing a different year in to  the
  71. year  gadget. The two tiny buttons beside the year gadget
  72. provide a convenient way of shifting the year up or  down
  73. by  one.  Note  that events will not be  highlighted  for
  74. years  before  1978.  I do not believe  the  calendar  is
  75. reliable for extreme dates but should be OK for the  next
  76. 40  years or so at least. (It shows 1900 and 2100 as leap
  77. years  - which they are not - although 2000 is, and  that
  78. is  correctly displayed (The full rule for leap years is:
  79. Years  exactly  divisible  by 4  are  leap  years  EXCEPT
  80. centenary   years,   but  in  the  case   of   millennial
  81. centenaries  like 1000 or 2000 they ARE leap  years  -  I
  82. think!)).
  83.  
  84. Clicking on a day will open the notes window, which lists
  85. events  noted for that date. Up to 20 one-line notes  can
  86. be  entered for a given date. Use the mouse to  highlight
  87. any existing note or an empty line. The text for the note
  88. can  be entered in the text gadget. The "Annual" checkbox
  89. should  be ticked for events like birthdays which  happen
  90. every  year,  and left clear for events like appointments
  91. which  relate  to  a specific date. These  two  different
  92. kinds  of events are highlighted in different colours  on
  93. the   calendar   (appointments  taking  precedence   over
  94. birthdays where both occur on the same day). You may also
  95. set  a number of days in the "Warning" gadget, which will
  96. put  up a reminder when the programme is started.  Use  0
  97. for no reminder.
  98.  
  99. After  setting these gadgets, use the SET button  to  set
  100. the  note. To delete a note, select it with the mouse and
  101. press DELETE. In either case the changes will not be made
  102. permanent  until you exit the window with the OK  gadget.
  103. The CANCEL gadget will discard the changes.
  104.  
  105. The  "Purge old events" checkbox causes old events to  be
  106. removed  from  the eventlist, but obviously those  marked
  107. "annual"  will  not be removed. Events are  only  removed
  108. when  new  notes  are set or deleted, but  there  is  one
  109. exception to this - when you check the purge checkbox for
  110. the  first  time, or uncheck it and check it  again,  old
  111. events  will  be deleted there and then. Thereafter  they
  112. will  only be removed when some other change is  made  to
  113. the  eventlist.  Note  that the  purge  checkbox  is  NOT
  114. associated with a particular date or a particular note.
  115.  
  116. The  "List  All" gadget lists the actual text file  which
  117. stores  the  events, using an external text  viewer.  The
  118. default is C:More, but you may change this in the fconfig
  119. file (see below).
  120.  
  121. The  three  slim buttons across the bottom of the  window
  122. have  the  following functions: the leftmost  resets  the
  123. calendar to the current month and year. The middle one is
  124. the  "only  show calendar" button, which  will  hide  the
  125. clocks.  If the clocks are already hidden, however,  they
  126. will  be restored by this button. Similarly the rightmost
  127. button  is the "only show clocks" gadget which will  hide
  128. or  restore the calendar. If only the clocks or only  the
  129. calendar  are  visible, you can toggle  between  them  by
  130. pressing  the appropriate button (if clocks  are  visible
  131. the  "only  show  calendar" button  will  switch  to  the
  132. calendar,  and  then the "only show clocks"  button  will
  133. take you back to the clocks).
  134.  
  135.  
  136. 4. OTHER CONFIGURATION OPTIONS
  137.  
  138. 4.1 fconfig file
  139.  
  140. This  is  a simple text file which should be in the  same
  141. directory  as the executable. You can use it to  set  the
  142. fonts  and colours used, and also the text viewer invoked
  143. to  list  all events. You can also change the file  names
  144. and locations for the eventlist and prefs files. The file
  145. that  is  included with the archive has all the  possible
  146. options  set.  Internal defaults exist in the  executable
  147. for  any which are missing from this file or if this file
  148. itself is missing.
  149.  
  150. See fconfig itself for more information.
  151.  
  152. The  two  fonts which can be set are for the gadget  text
  153. and  the  clock  and calendar text. The  latter  (set  in
  154. fconfig  as,  say _8X8_FONT=p0t-noodle.font)  must  be  a
  155. fixed 8x8 font.
  156.  
  157. The  colours  are  the first and last four  from  the  WB
  158. palette  and  should  remain correct regardless  of  your
  159. screen depth. Which are used for each part of the display
  160. may be changed in fconfig (rather laboriously, I admit).
  161.  
  162. 4.2 lconfig file
  163.  
  164. The  lconfig file contains all the text strings  used  in
  165. the  programme.  If it is not present then  the  internal
  166. English  defaults will be used, however, by changing  the
  167. strings  in  this  file it is possible  to  localise  the
  168. programme  for other languages. Care must be  taken  that
  169. the strings are entered in the same fixed order, and that
  170. they   consist  of  approximately  the  same  number   of
  171. characters.  The  strings for days and months  must  have
  172. spaces (for the days) and | dividers (for the months)  as
  173. in the English version. See lconfig for more details.
  174.  
  175.  
  176. 5.  TECHNICAL NOTES
  177.  
  178. Most  of  the time the programme sits idle, only checking
  179. for input every quarter of a second. This means there may
  180. be a slight delay when you first hit a gadget. As soon as
  181. a   gadget   is   hit   however,  the  programme   checks
  182. continuously for input, until a full minute  passes  with
  183. no user-action, when it goes back to its standby state.
  184.  
  185.  
  186. 6. OTHER INFO
  187.  
  188. Author:   Mike Child     mike@mikech.demon.co.uk
  189. Tools used:    Blitz Basic 2.1
  190. Written on:    A1200 Apollo060@66 32MB WB3.0
  191.  
  192. Thanks   to   the   subscribers  to   BlitzList   (blitz-
  193. list@netsoc.ucd.ie) for solving some queries.
  194.  
  195.  
  196. 7. HISTORY
  197.  
  198. Version 1.0 - Initial release
  199. Version 1.1 - Added automatic update of today indicator
  200.               in calendar at turn of midnight. 
  201.